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A COOKBOOK FOR THE XMMSAS 
D. Grupe^ 

Max-Planck-Institut fur extraterrestrische Physik, Giessenbachstr. D-85748 Garching, Germany 


Abstract 

This paper will give a short description of a ‘cookbook’ 
for the XMM-Newton data reduction software XMMSAS. 
This ‘cookbook’ has been developed at the Max-Planck- 
Institut fiir extraterrestrische Physik (MPE), Garching. 
The task of this ‘cookbook’ is to describe the necessary 
XMMSAS tasks and show examples to make it easy for 
new users of the XMMSAS to understand the steps which 
have to perform to reduce their XMM X-ray data. 
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1. Introduction 

When working with X-ray data each X-ray mission has its 
own software package to reduce the data due to the spe¬ 
cific requirements of the detectors onboard. For the XMM- 
Newton mission the reduction software package XMMSAS 
has been developed. The main purpose of the XMMSAS is 
to allow users to take the Observational Data File (ODF) 
and create event files and at a later stage scientific files 
like images, spectra and lightcurves. Each XMMSAS task 
has a manual either in HTML format or as a postscript 
file (please see at 

xmm. vilspa. esa. es/s as/current/doc/packages. All. html 
to get the whole list of available XMMSAS tasks). The 
manual gives a description of the tasks and lists all avail¬ 
able task parameters. However, this is often confusing to 
new users of the XMMSAS in order to see which tasks are 
needed and how they have to be applied to their data. For 
this reason at MPE the idea was born to design a web- 
based cookbook that explains users how to work with their 
XMM-Newton observational data hies (ODF) in order to 
create hnal scientihc hies like spectra and light curves. At 
hrst this cookbook was only written for users at MPE, 
but it has been now designed and make accessible to users 
from outside the MPE. 

2. The Cookbook 

To explain the tasks that have to be performed to create 
event hies and hnally scientihc hies, the cookbook hrst de¬ 
scribes general tasks and is then organized by the instru¬ 
ments onboard XMM. There are chapters for EPIC PN, 


EPIC MOS, the RGS, and the Optical Monitor (OM).The 
two EPIC chapters have an introductory part and are then 
split into sections for spatial, spectral and timing analysis 
of the data. Fig displays as an example the EPIC PN 
page. The cookbook has the following structure: 

1. General tasks 

2. Data Preparation 

3. EPIC PN 

— Spatial analysis 
— Spectral analysis 
— Timing analysis 

4. EPIC MOS 

— Spatial analysis 
— Spectral analysis 
— Timing analysis 

5. RGS 

6. Optical Monitor 

3. Where to find the Cookbook 

The MPE cookbook for the XMMSAS can be found here: 

[http: //yyave.xray.mpe.mpg.de/xmm/cookbook/ 

4. Other XMMSAS documents 

The MPE XMMSAS ‘cookbook’ is of course not the only 
description of the XMMSAS. First there is ESA’s official 
XMMSAS users guide which is available at V ILSPA: 
http://xmm. vilspa. esa. es/sas/documentatio'i\ 

Another highly-recommended documentation is the ABC 
Guide created at NASA/GSFC which is available in HTML, 
postscript and pdf format: _ 

^ttp:/ /heasarc.gsfc. nasa.gov/docs /xmm/ahc /abc. htmi 
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Examples: 

► Introduction 

► Pipeline Products overview 

► Description of an EPIC PN PDF 

► Create calibrated EPIC PN events file from 
PDFs 

► Description of an EPIC PN event file 

► Create out-of-time events file from PDFs 

► Display percentage of Single/Double events 

► Create simple image 

► Create point source spectrum 

► Create light curve 

► Source & background counts 

► Select region 

► Create exposure map 

► Source detection 


Other instruments: 

► EPIC MPS data 

► RGS data 

► Pptical Monitor (PM) data 

Documents 

► XMM-Newton Users' handbook 

► XMMSAS Users' Guide fhtmh. 
also available as a Postscript file . 

► XMMSAS ABC Guide (NASA/GSPCt 

► SAP! mage 

► Software Analysis Documents 

► FITS Standards Resources 

► FTPPLS 


Figure 1. This is an example of a ‘cookbook’ page. This example shows the EPIC PN page 





